package com.campus.activity.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.campus.activity.entity.User;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author System
 * @since 2024
 */
public interface UserService extends IService<User> {

    /**
     * 用户登录
     * 
     * @param username 用户名
     * @param password 密码
     * @return 用户信息
     */
    User login(String username, String password);

    /**
     * 用户注册
     * 
     * @param user 用户信息
     * @return 是否成功
     */
    boolean register(User user);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);

    /**
     * 根据用户角色查询用户列表
     * 
     * @param userRole 用户角色
     * @return 用户列表
     */
    List<User> getUsersByRole(String userRole);

    /**
     * 更新用户密码
     * 
     * @param userId 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean updatePassword(Integer userId, String oldPassword, String newPassword);

    /**
     * 根据学生ID查询用户
     * 
     * @param studentId 学生ID
     * @return 用户信息
     */
    User getUserByStudentId(Integer studentId);

    /**
     * 根据组织者ID查询用户
     * 
     * @param organizerId 组织者ID
     * @return 用户信息
     */
    User getUserByOrganizerId(Integer organizerId);

    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @return 是否存在
     */
    boolean isUsernameExists(String username);

    /**
     * 验证密码
     * 
     * @param rawPassword 原始密码
     * @param encodedPassword 加密密码
     * @return 是否匹配
     */
    boolean verifyPassword(String rawPassword, String encodedPassword);

    /**
     * 加密密码
     * 
     * @param password 原始密码
     * @return 加密后的密码
     */
    String encodePassword(String password);
}